Inside Macintosh: QuickTime Components /

Chapter 9 - Movie Data Exchange Components / Movie Data Exchange Components Reference

Configuring Movie Data Export Components /

MovieExportSetProgressProc

The MovieExportSetProgressProc function allows an application to assign a movie progress function.

pascal ComponentResult MovieExportSetProgressProc
                                     (ComponentInstance ci, 
                                       MovieProgressProcPtr proc, 
                                       long refcon);

ci

Identifies the application's connection to your movie data export component.

proc

Contains a pointer to the application's movie progress function. See the chapter "Movie Toolbox" in Inside Macintosh: QuickTime for a complete description of the interface supported by movie progress functions. If this parameter is set to nil, the application is removing its progress function. In this case, your component should stop calling the progress function.

refcon

Specifies a reference constant. Your component should pass this constant back to the application's progress function whenever you call that function.

DESCRIPTION

Some data export operations may be time-consuming, and application developers may therefore choose to display progress information to the user. Your component provides this information to an application's progress function. As your component processes an export request, you should call the progress function occasionally in order to report on the progress of the operation. Use a progress code of progressOpExportMovie. The application can then present this information to the user.

These progress functions must support the same interface as Movie Toolbox progress functions. That interface is discussed in the chapter "Movie Toolbox" in Inside Macintosh: QuickTime. Note that this interface not only allows you to report progress to the application, but also allows the application to cancel the request.

RESULT CODE

badComponentSelector

0x80008002

Function not supported

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help